home *** CD-ROM | disk | FTP | other *** search
/ Workbench Add-On / Workbench Add-On - Volume 1.iso / Text / Util / Column / Column.doc < prev    next >
Text File  |  1995-04-04  |  4KB  |  99 lines
  1.                                           ***RGR*** 1994
  2.  
  3.  COLUMN     -     generates columns from any ASCII text
  4.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  5.  A tool for PageStream  (or other DTP programs)
  6.  
  7.  Introduction
  8.  ------------
  9.  This directory contains a tool to split any ASCII textfile
  10.  into multiple columns (a new file for each column).
  11.  I wrote this, because I had to import a listing generated
  12.  with the report generator of dBMAN from Versasoft (the only
  13.  xBASE compatible database program on Amiga) into a
  14.  PageStream 2.21 document.
  15.  The listing contained columns, but with spaces, and so I
  16.  could not use a proportional font in my document. 
  17.  Maybe other DTP users have the same problem - here
  18.  is a solution.
  19.  
  20.  Since release of PageStream 3.0 things are much easier - the
  21.  new tabulator types solve many problems, but my program
  22.  can nevertheless help you if you have to remove columns or
  23.  if you want to format some columns with different fonts or
  24.  sizes or in block format. 
  25.  
  26.  
  27.  Column is © 1993/1994   Ralf Gruner
  28.                          An der Sense 5a
  29.                          D-02779 Großschönau
  30.                          Germany
  31.  
  32.  Column should only be distributed in combination with
  33.  this documentation.
  34.  
  35.  If you are a professional DTP user and you are happy about
  36.  Column, you should send me a postcard.
  37.  
  38.  This distribution contains versions of Column for two languages:
  39.  English (Column) and German (Column.deutsch).
  40.  
  41.  To show how Column works I have included Demonstration.script.
  42.  You can start it by clicking on this icon, it works only in the
  43.  ram disk and will not change anything on your drives.
  44.  
  45.  
  46.  Short instructions:
  47.  -------------------
  48.  Column generates new files, one for each column,
  49.  your original text keeps unmodified. So you can import
  50.  the columns separate to the columns of your document
  51.  and use various format operations.
  52.  
  53.  Column can only be started from the Shell:
  54.  
  55.  column <filename> <position 1> [<position 2> ... [<position n>]...]
  56.  
  57.  Filename is your text, position 1 ... position n  are the
  58.  values of the column positions (right margin).
  59.  Column will now generate n new files with the name of the
  60.  original textfile and append the suffix .col1, .col2, .col3
  61.  and so on. The number of columns is limited to 16 (maximum
  62.  of simultaneous open files for each Amiga OS process),
  63.  but this should be enough.
  64.  If a line of the text is longer than position n (the most
  65.  right position) the rest of this line will be truncated.
  66.  After its work Column will tell you the number of
  67.  truncated lines if any.
  68.  
  69.  Example: The textfile TEXT should be splitted into three
  70.  columns, the first column are the first three characters,
  71.  the second column are the next five characters and the
  72.  third column is the rest of the line:
  73.  
  74.  column text  3  8  999
  75.  
  76.  (The 999 for column3 is an arbitrary value, I presume that
  77.  no line of the example text has more characters than 999.)
  78.  Now three new files are generated:
  79.  text.col1, text.col2 and text.col3, containing the columns.
  80.  
  81.  Column will display the text and the column positions while
  82.  splitting, so you can check your input and retry with
  83.  changed values after Column has finished the splitting.
  84.  Already existing files will be overwritten.
  85.  
  86.  Ralf Gruner
  87.  
  88.  
  89.  
  90. ----------
  91. Disclaimer
  92. ----------
  93. This program is provided "as is" without warranty of any kind, either
  94. expressed or implied, including, but not limited to, the implied warranty
  95. of fitness for a particular purpose.  Though every care has been taken to
  96. make this program system-friendly and bugs-free, the entire risk as to the
  97. results, reliability and performance of this program is assumed by you.
  98.  
  99.